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1. INTRODUCTION 

The CP-5 I/O System (lOQ) will provide all input-output 
facilities for disk storage, magnetic tape, local card 
readers and punches, local line printers, and the system 
console. In addition, it will provide connect and interrupt 
facilities for the direct channel to the L6 Front End. 



This document describes the release^ version of lOQ. For 
initial testing there will be an interim version based on 
GCOS lOS. This interim version will have the Monitor 
interfaces described in Sections 2, 3, and 4, but it will not 
have all of the error recovery or Test and Diagnostics (T&D) 
facilities described in Sections 5 and 6. As lOQ evolves 
from the interim version to the release version, these 
facilities will be added. 



Sections 2, 3» and 4 describe the interface which will be 
used for all normal I/O, i.e., all I/O except T&D. Section 2 
is a functional overview. Section 3 describes the I/O request 
packet, and Section 4 describes the calling sequences. 

Section 5 describes the error recovery and logging techniques 
to be used by lOQ. 

Section 6 describes the T&D interface to lOQ. 
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2. FUNCTIONAL OVERVIEW OF "NORMAL-MOD E" SERVICES 

Functionally the services provided by CP-6 lOQ are similar in 
nature to the CP-V lOQ services. Callers specify logical 
function codes and device indices along with buffer 
description and end-action information. lOQ then calls a 
device pre-handler to build the command list needed to 
perform the operations, starts the I/O, and upon completion 
reports the type completion code to the caller via the user's 
DCB or end-action routine. The major function differences 
arise from the way information is passed to and returned from 
lOQ. 



In CP-6, the lOQ tables consist of a pool of queue entry 
packets. To issue an I/O request one first requests a free 
queue entry or packet. The request routine returns a PL-6 
pointer to the packet, which the caller uses with a based 
structure template to stuff the packet. The pointer to the 
packet is then passed to the queuing routine which processes 
the request. After post-processing of the I/O operation 
completion, if end-action was requested by the caller, the 
packet (now including completion status like type completion 
and actual record size) is passed to the end-action routine. 
Upon return from the end-action, the packet is either freed 
or re-queued, depending on a flag set by the end-action 
routine . 

The second source of difference arises from a generalization 
of the AVR service in CP-V. On the L66 system all devices 
generate special interrupts - interrupts not necessarily the 
result of an I/O operation - such as when a device changes 
state from manual to ready. In CP-6, lOQ will provide a 
generalized service allowing monitor routines to gain control 
of these interrupts on a selective basis by device index. 

lOQ provides for both mapped and non-mapped I/O, either 
user-associated or not, wait or no-wait service, DCB posting, 
event posting, end-action control, and special interrupt 
control. The following sections describe each of these 
services . 



This service is exactly like CP-V»s NEWQNW. No system 
scheduler service is involved, the I/O is always queued and 
an immediate return made to the caller. At completion, the 
specified end-action routine is called. Using a buffer 
pointer format of BUFPPNO, any page in the first 16M words of 
real memory may be addressed. It is also possible to perform 
non-user associated I/O, using a users map (such as for 
"swapping"). The use of a map for the I/O is dependent only 



2.1 



Non-User Associated I/O 
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on the descriptor of the buffer as referenced by the PL-6 
pointer. Non-user associated requests imply no system 
scheduler interfaces and no posting of status in a DCB. 



2.2 User-Associated I/O 

This service provides an interface which is a logical 
combination of NEWQ and QUEUE. User-associated I/O implies 
system scheduler interfaces such as Master Function Count 
check and the possibility of services like waiting on the I/O 
operation, posting status in the user's DCB and reporting 
event completion. Master Function Count check is always 
performed for user-associated I/O resulting in blocking the 
user if he has exceeded the master function limit for his job 
class (online or batch). The other functions of this service 
request are selectively enabled by bit flags in the request 
packet or by the parameters of the call. (See Section 4. - 
Calling Sequences - for details.) 



2.3 Special Interrupt Control 

The device tables will contain the address to which control 
will be transferred upon receipt of special interrupts. This 
address may be separately established for each device by a 
call on lOQ specifying the device index (DCTX) and the entry 
point to which control is to be passed. At the time of a 
special interrupt, if such control has been established, the 
DCTX and the interrupt status word will be passed to the 
specified address for processing. The special interrupt 
request will remain in effect until an explicit call is made 
to lOQ to disable the request. 

It is conceivable that a monitor service could be provided to 
allow a user to get control (a la M:INT) for special 
interrupts on a device currently allocated to him. 



2.4 Cleanup of User-associated I/O 



There will be an entry provided to clean up all I/O for a 
user job when that job terminates. 
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3. QUEUE PACKET FORMAT 



DCL 1 NISREQ BASED ALIGNED, /* I/O REQUEST PACKET */ 

012345678012345678012345 6.7 8012345678 



0 


FL$ 


1 
1 


1 




1 


I DLA 

SETX ISETADDR 


1 






2 


1 BUFSIZE 


1 * 1 FC 
t 1 
1 1 


1 OPFLG 
1 U i A 1 E 


EiWiBIH'.RlS 


3 


BUF$ 








4 


IPTP 


1 « 






5 


|DCB$ 








6 


lEAENTRY 




1 ...... 




7 


1 EAINFO 


1 


; 




10 


EVNTINFO 








1 1 


A r% o "T T 

ARSIZE 


1 * 1 CC 
I lERR 
1 1 1 1 P 1 1 


It! 1^ TS If 

1 USER// 
lABN 1 
1 E 1 E ! B I 




12 


ARCT 








13 


RCT 








14 


ILPWX 
IBASE 


iSIZE 






15 


ISCT 


1 ADCW2 
1 


I 




1 6 


DCWLIST 


1 








LEVEL 2 ARRAY: 6 ( ' 6*0) 


ENTRIES TOTAL. 
1 






24 


ISEEK 

ISCL ISSZ 


{SECTOR 
1 


1 




25 


CL$ 


1 






26 


ISTATUS1 

jPIPIMAJOR {MINOR }* 


IIOM 


1 


RCR 


27 


ISTATUS2 
INXTADDR 


INXTCH IR !* 
1 


1 
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2 FL$ PTR, 

2 DLA ALIGNED, 

3 SETX UBIN(9) UNAL, 

3 SETADDR UBINC27) UNAL, 
2 BUFSIZE UBIN(20) UNAL, 
2 * BITC1 ) UNAL, 
2 FC UBINC6) UNAL, 
2 OPFLG, 

3 USER BITCI ) UNAL, 

3 ARS BITd ) UNAL, 

3 EVNT BIT(I) UNAL, 

3 EA BITCI ) UNAL, 

3 WAIT BITCI ) UNAL, /* BLOCK 

3 BPF BITCI ) UNAL, 

3 HOLD BITCI ) UNAL, 

3 REQ BITCI ) UNAL, 

3 SET BITCI ) UNAL, 
2 BUFS PTR, 

2 PTP UBINCia) UNAL, 
2 * SBIN HALF UNAL, 
2 DCB$ PTR, 
2 EAENTRY EPTR, 
2 EAINFO UBINC3b) , 
2 EVNTINFO UBIN(36) , 
2 ARSIZE UBINC20) UNAL, 
2 * BITCI) UNAL, 
2 CC, 

3 ERR, 

4 10 BITCI ) UNAL, 
4 PE BITCI ) UNAL, 
4 INVD 3ITC1 ) UNAL, 

3 ABN, 

4 EOF BITCI ) UNAL, 
4 EOT BITCI ) UNAL, 
4 BOT BITCI ) UNAL, 
2 USER// UBINC9) UNAL, 
2 ARCT SBIN UNAL, 
2 RCT SBIN UNAL, 
2 LPWX ALIGNED, 

3 BAiSE UBINCIb) UNAL, 

3 SIZE UBINCIb) UNAL, 
2 SCT UBINCIb) UNAL, 
2 ADCW2 UBINC18) UNAL, 
2 DC^LISTC0:5) UBINC3b) , 
2 SEEK ALIGNED, 

3 SCL UBINC12) UNAL, 

3 SSZ UBINC4) UNAL, 

3 SECTOR UBINC20) UNAL, 
2 CL$ PTR, 
2 blATUSI ALIGNED, 

3 PRESENCE BITCI ) UNAL, 



/* LINK TO NEXT PACKET IN QUEUE */ 

/* DEVICE LOGICAL ADDRESS */ 

/* DEVICE OR SET INDEX */ 

/» DEVICE- OR SET-RELATIVE ADDRESS */ 

/* BUFFER SIZE CBYTES) */ 

/» LOGICAL FUNCTION CODE */ 

/* OPERATION FLAGS */ 

/» USER-ASSOCIATED I/O »/ 

/* SET ARS OF DCB */ 

/* REPORT COMPLETION EVENT */ 

/» CALL END-ACTION ROUTINE */ 

ASSOCIATED USER AFTER QUEUEING REQUEST 

/» BUF$ CONTAINS PTR -> BUFFER */ 

/* DO NOT RELEASE PACKET ON COMPLETION 

/» RE-QUEUE PACKET */ 

/» 0=REQ TO DEV, 1=REQ TO SET */ 

/* "BUFS PTR" IF BPFr'VB »/ 

/* "BUFADDR UBINC26)" IF BPF=»0'B */ 

/* BPFrO: PAGE TABLE POINTER CO=REAL) * 

/* -> USER'S DCB */ 

/* END-ACTION PROCEDURE »/ 

/* END-ACTION PARAMETER »/ 

/* EVENT INFO */ 

/* ACTUAL RECORD SIZE */ 

/» LOGICAL COMPLETION CODE CO=OK) »/ 

/* I/O ERROR */ 

/* PARITY ERROR */ 

/* INVALID OPERATION */ 

/* END-OF-FILE »/ 

/* END-OF-TAPE »/ 

/* BEGINNING-OF-TAPE */ 

/» USER ID */ 

/* ACTUAL RECORD COUNT */ 

/* RECORD COUNT »/ 

/* LIST POINTER WORD EXTENSION */ 

/* LOWER BOUND CMOD 2 WORDS) */ 

/* SIZE CWORDS) */ 

/* DEVICE TABLE ADDRESS */ 

/* ADDRESS OF SECOND DCW LIST */ 

/* DCW LIST */ 

/* DISK SEEK ADDRESS WORD »/ 

/* SECTOR COUNT LIMIT */ 

/» SECTOR SIZE */ 

/* SEEK ADDRESS */ 

/* LINK TO DCW LIST PACKETS */ 

/* STATUS WORDS »/ 
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3 POWEKOFF BITCI ) UNAL, 
3 MAJOR 3IT(4) UNAL, 
3 MINOR BITCb) UNAL, 
3 » BITCb) UNAL, 
3 lOM BIT(6) UNAL, 
3 * BITCb) UNAL, 
3 RCR UBINCb) UNAL, 
2 STATUS2 ALIGNED, 

3 NXTADDR UBINCia) UNAL, 
3 NXTCHAR UBINC3) UNAL, 
3 READFLG BIT CD UNAL, 
3 » BITC14) UNAL; 



/* POWER OFF STATUS */ 
/* DEVICE MAJOR STATUS */ 
/* DEVICE MINOR STATUS */ 

/• lOM / CHANNEL STATUS */ 

/* RECORD COUNT RESIDUE */ 
/« 2ND STATUS WORD */ 
/* NEXT ABS ADDRESS »/ 
/* NEXT CHAR POSITION */ 
/* READ/WRITE FLAG */ 
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DCL 1 NI$VREQ BASED ALIGNED, /* I/O REQUEST PACKET */ 

0123^56780123456780123^5678012345678 



0 


FL$ 


1 
1 






1 
1 












1 


DLA 

DCTX IDRFLADDR 


1 


















2 

•mm 


BUFSIZE 


1 * ! FC 

1 1 
1 1 






! OPFLG 
lU lAlE 


E!W1 


B' 


H 


R 


IS 


3 


IBUFADDR 








// # # 


a it 


ii 


it 


it 




4 


PTP 


1 * 


















5 


DCB$ 




















6 


EAENTRY 




















7 


EAINFO 


1 


















1 n 


F VM T T W F n 




















1 1 

1 1 


1 n n O XZ< III 


! * ! rr 

1 lERR 
! ! T ! P ! T 


A3N 

! F ! F 


n 


u o r, n 
















1 


















13 


IRCT 




















14 


ILPWX 
RASE 


1 ST7F 


















15 


SCT 


} ADCW2 


















16 


IDCWLIST 






















LEVEL 2 ARRAY: b (' b'O) 


ENTRIES TOTAL. 


















24 


'SEEK 

,SCL ISSZ 


! SECTOR 


















25 


CL$ 




















26 


ISTATUS1 

IP IP 1 MAJOR {MINOR 1* 


IIOM 
• 






— 


RCR 










27 


;STATUS2 
INXTADDR 


iNXTCHIR J* 
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2 FL$ PTR, 

2 DLA ALIGNED, 

3 DCTX UBIN(9) UNAL, 

3 DRELADDR UBIN(27) UNAL, 
2 BUFSIZE UBIN(20) UNAL, 
2 » BIT(I) UNAL, 
2 FC UBIN(6) UNAL, 
2 OPFLG, 

3 USER BITCI ) UNAL, 

3 ARS BITCI ) UNAL, 

3 EVNT BITCI ) UNAL, 

^ EA BITCI ) UNAL, 

3 WAIT BITCI) UNAL, /* BLOCK 

3 BPF BITCI ) UNAL, 

3 HOLD BITCI ) UNAL, 

3 REQ BITCI ) UNAL, 

3 SET BITCI ) UNAL, 
2 BUFADDR UBINC2b) , 

2 FTP UBINC1B) UNAL, 
2 » SBIN HALF UNAL, 
2 DCBS PTR, 
2 EAENTRY EPTR, 
2 EAINFO UBINC3b) , 
2 EVNTINFO UBINC3b) , 
2 ARSIZE UBINC20) UNAL, 
2 * BITCI ) UNAL, 
2 CC, 
3 ERR, 

4 10 BITCI ) UNAL, 
4 PE BITCI) UNAL, 
4 INVD BITCI ) UNAL, 
3 ABN, 

4 EOF BITCI ) UNAL, 
4 EOT BITC1 ) UNAL, 
4 BOT BITCI ) UNAL, 
2 USER# UBINC9) UNAL, 
2 ARCT SBIN UNAL, 
2 RCT SBIN UNAL, 
2 LPWX ALIGNED, 

3 BASE UBINCia) UNAL, 
3 SIZE UBINC18) UNAL, 
2 SCT UBINC18) UNAL, 
2 ADCW2 UBINC18) UNAL, 
2 DCWLISTC0:5) UBINC3b) , 
2 SEEK ALIGNED, 

3 SCL UBINC12) UNAL, 
3 SSZ UBINC4) UNAL, 
3 SECTOR UBINC20) UNAL, 
2 CL$ PTR, 
2 STATUS1 ALIGNED, 

3 PRESENCE BITCI ) UNAL, 



/» LINK TO NEXT PACKET IN QUEUE */ 

/* DEVICE LOGICAL ADDRESS */ 

/» DEVICE OR SET INDEX »/ 

/* DEVICE- OR SET-RELATIVE ADDRESS »/ 

/* BUFFER SIZE CBYTES) */ 

/* LOGICAL FUNCTION CODE */ 

/» OPERATION FLAGS */ 

/* USER-ASSOCIATED I/O */ 

/* SET ARS OF DCB */ 

/* REPORT COMPLETION EVENT */ 

/* CALL END-ACTION ROUTINE */ 

ASSOCIATED USER AFTER OUEUEING REQUEST 

/* BUF$ CONTAINS PTR -> BUFFER »/ 

/* DO NOT RELEASE PACKET ON COMPLETION 

/* RE-QUEUE PACKET »/ 

/* OrREQ TO DEV, 1=REQ TO SET »/ 

/* "BUFS PTR" IF BPFrM'B */ 

/* "BUFADDR UBINC26)" IF BPF='0'B */ 

/* BPF=0: PAGE TABLE POINTER CO=REAL) 

/« -> USER'S DCB */ 

/» END-ACTION PROCEDURE */ 

/* END-ACTION PARAMETER */ 

/* EVENT INFO */ 

/* ACTUAL RECORD SIZE */ 

/* LOGICAL COMPLETION CODE C0=OK) »/ 

/* I/O ERROR */ 

/» PARITY ERROR */ 

/* INVALID OPERATION */ 

/* END-OF-FILE */ 

/* END-OF-TAPE */ 

/* BEGINNING-OF-TAPE */ 

/» USER ID »/ 

/* ACTUAL RECORD COUNT */ 

/* RECORD COUNT */ 

/* LIST POINTER WORD EXTENSION */ 

/* LOWER BOUND CMOD 2 WORDS) «/ 

/* SIZE CWORDS) */ 

/» DEVICE TABLE ADDRESS */ 

/* ADDRESS OF SECOND DCW LIST */ 

/» DCW LIST */ 

/* DISK SEEK ADDRESS W'ORD */ 

/» SECTOR COUNT LIMIT */ 

/* SECTOR SIZE */ 

/» SEEK ADDRESS */ 

/* LINK TO DCW LIST PACKETS */ 

/* STATUS WORDS */ 
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3 POWEROFF BITCI ) UNAL, 
3 MAJOR BIT(M) UNAL, 
3 MINOR BIT(6) UNAL, • 
3 * BIT(6) UNAL, 
3 lOM BIT(6) UNAL, 
3 * BITCb) UNAL, 
3 RCR UBIN(6) UNAL, 
2 STATUS2 ALIGNED, 

3 NXTADDR UBINC18) UNAL, 
3 NXTCHAR UBINC3) UNAL, 
3 READFLG BITCI ) UNAL, 
3 * BIT(14) UNAL; 



/* POWER OFF STATUS «/ 
/* DEVICE MAJOR STATUS */ 
/» DEVICE MINOR STATUS »/ 

/* lOM / CHANNEL STATUS */ 

/* RECORD COUNT RESIDUE */ 
/* 2ND STATUS WORD */ 
/* NEXT ABS ADDRESS */ 
/* NEXT CHAR POSITION */ 
/* READ/WRITE FLAG */ 
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3.1 Logical Function Codes 



NAME 


DEFINITION 


L n L r L r 


u r 


n 1 


oL 


NI RQSTAT 


Request status 


V V V 
AAA 


Y 

A 


Y 

A 


Y 

A 


NI_RDBIN 


Read binary 


V 

A 


V 

A 


V 
A 




NI_RDASC 


Read ASCII 


V 

X 




V 

X 


V 

X 


NI WRBIN 


Write binary 


Y 
A 


V 
A 


V 

A 




NI WRASC 


Write ASCII 


V V 

X X 




V 

X 


V 

X 


NI WRCMP 


Write and compare 




V 

X 






NI_WRAi3CED 


Write AbCII edited 


V 

A 








NI ALARM 


Turn on operator alarm 








V 

A 


NI SLEW 


Slew 


V 

X 








NI LDVFC 


Load VFC image 


X 








NI_LDCHAIN 


Load print chain image 


V 

A 








NI RDSTREG 


Read status register 


Y 
A 


Y 
A 


A 




NI RDEBC 


Read EBCDIC 






X 




NI WREBC 


Write EBCDIC 






X 




NI WRFM 


Write file mark 






X 




NI SPREC 


Space records 






X 




NI SPFILE 


Space files 






X 




NI SD800 


Set density=800 






X 




NI SDIbOO 


Set density=:1600 






X 




NI SD6250 


Set density=6250 






X 




NI REWIND 


Rewind 






X 




NI UNLOAD 


Rewind and unload 






X 




NI PERMIT 


Tape write permit 






X 




NI PROTECT 


Tape write protect 






X 
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The status codes with "TYC" in the type column have a 
one-to-one correspondence with bits in the TYC field of DCB 
and will be reported therein. 
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4. CALLING SEQUENCES 



4.1 NIQSGET 

Call form: 

CALL NIQ$GET(Q$); 
Purpose: 

NIQ$GET obtains a pointer to a queue entry packet. The 
queue format is described in Section 3. A based 
structure is used by the requesting routine to fill in 
the appropriate information. 

If no packets are available and there is a current user, 
a "no packet available" event will be reported to the 
scheduler and the user will be blocked. If there is no 
current user, NIQSGET will loop, trying to start I/O, 
until a packet becomes available. 



4.2 Nig$REL 

Call form: 

CALL NIQ$REL(Q$); 
Purpose : 

NIQ$REL frees the packet specified by Q$. This routine 
would normally be used only by lOQ, but others could use 
it. 

If this packet is now the only available packet the 
scheduler is called to report "qreue packet available". 



4.3 NIO$DEVIO 
Call form: 

CALL NIO$QUE(Q$)ALTRET(label) ; 
where Q$ is the PTR returned from a call on NIQ$GET. 
Purpose : 

NIO$DEVIO queues a request for I/O on a particular 
logical device index (DCTX). 



0160B-2 
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To issue an I/O request, one calls NIQ$GET which returns a 
pointer to the queue packet to be used. Various fields of 
the queue packet (as described by a based structure) must be 
filled in specifying the operation to be *per formed . (See 
Section 3.) 

The alternate return is taken if: 

o DCTX is not a valid device table index. 

o DRELADDR is not a valid address on this disk. 

o FC is not a valid logical function code. 

In addition to the above reasons, the alternate return is 
taken if OPFLG.SET = M'B and: 

o SETX is not a valid pack set index. 

o SRELADDR is not a valid address in this packet set. 



4.4 End-Action Routine 
Call form: 

CALL EAENTRY(Q$); 
where : 

EAENTRY is the end action routine specified in the queue 
packet . 

Q$ is a PL-6 pointer to the queue packet. 

When the end-action routine is called, the buffer address 
will be in BUFADDR and PTP of the queue packet and OPFLG.BPF 
will be set to M »B. 

OPFLG.REQ in the queue packet will be set to 'O'B by ICQ. 
The end action routine may set this flag to '1*8 to indicate 
to ICQ that the packet is to be requeued. If OPFLG.REQ is 
set to 'O'B, the disposition of the packet is controlled by 
OPFLG.HOLD. If the latter is M'B, the packet will not be 
released. In this case, it is up to the caller to release 
the packet when he is done with it. 



4.5 Scheduler Interfaces 

lOQ interfaces with the scheduler to provide three basic 
functions. These are: 
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Ability to wait on user associated I/O. This means that 
the call on NIO$DEVIO or NIOSSETIO does not return until 
the I/O operation is completed. 

Ability to limit the number of outstanding I/O requests 
for a user. This check - called Master Function Check - 
is always invoked for user associated I/O and causes the 
user to be blocked until previous requests complete. 
The I/O request which causes the block is not queued 
until after the scheduler determines that the Master 
Function Count is below the users threshold. 

Ability to cause asynchronous reporting of an I/O 
complete event to the user^s program. 

Report that no queue packets are available. The current 
user is to be blocked until a queue packet becomes 
available . 

Report that a queue packet is now available. This 
allows the scheduler to unblock all users who were 
previously blocked for lack of a queue packet. 

calls to the scheduler to provide these functions are: 

CALL SSR$REG(SS__IIP,DCB$); 

Place the current user in the I/O in progress state 
until I/O complete occurs. 

SS__IIP is the I/O In Progress event code. 

DCB$ is the PL-6 PTR to the user's DCB. 

CALL SSR$REG(SS_QMF) ; 

Block the current user because his Master Function 
Count is exceeded. 

SS__QMF is the Queue for Master Function event code. 
CALL SSR$RUE([SS_IOC,SS lOCU ] , USR# , DCBS , EVNTIFO ) ; 



Report I/O complete event to the scheduler. 

SS_IOC is the I/O Complete event code. 

SS lOCU is the I/O Complete and unblock event code. 
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USR# is the user// of the user associated with the 
I/O. 

DCB$ is the PL-6 pointer to the' user's DCB. 

EVNTIMFO is 72 bits of information including TYC 
and the user's EVNTINFO to be reported to the user 
asynchronously . 

CALL SSR$REG(SS_NQP); 

Block the current user when no queue packets are 
available . 

CALL SSR$RE(SS_QPA); 

Unblock all users who were blocked for lack of a queue 
packet . 



4.b Request for Special Interrupt Control 
Call form: 

CALL NIO$SPINTCON(DCTX, INTADDR,EAIMFO) ALTRETC label ) ; 
where : 

DCTX is the logical device index for which special 
interrupt control is requested. 

INTADDR is the procedure name ( as a PL-6 entry pointer) 
to which control is to be transferred when a special 
interrupt occurs on this device. This address must be 
within the monitor's instruction segment. The special 
interrupt request remains in effect until it is cleared 
by a call to NIOSSPINTCON with EADDR=NULL. 

EAINFO is a data word to be passed to the special 
interrupt end action routine. 

The alternate return is taken if: 

o DCTX is not a valid device table index. 

o The device does not generate special interrupts. 

o Special interrupts are already requested for the device. 
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4.7 



Special Interrupt End Action Routine 



Call form: 



CALL INTADDR (DCTX, INTSTAT, EAINFO) ; 



where : 



INTADDR is the end-action routine specified in the call 
to NIO$SPI»TCON. 

DCTX is the device index of the interrupting device. 

INTSTAT contains a logical status code indicating the 
type of special interrupt that occurred. See Section 



4.B Clean Up All User I/O 
Call form: 

CALL NIS$ABIO(USR//); 
where : 

USR# is the user number. 



Abort and clean up all I/O associated with the specified 



3.2. 



Purpose : 



user . 
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5. ERROR RECOVERY AND LOGGING 



5.1 Error Recovery 

lOQ will perform all error recovery for normal I/O requests. 
The action taken depends on the device type and the status 
returned from the I/O operation. 

Basically there are five distinct types of status which may 
occur during an I/O operation. These are listed in the 
following paragraphs with examples and action taken. 



5.1.1 Normal Completion 
Ex ample : 

Channel Ready 
Action: 

This the normal completion of an I/O request; a normal 
completion code is returned to the caller (i.e., to the 
DCS and/or end-action routine) . This category includes 
status codes that indicate that the MPC (microprogrammed 
controller) firmware corrected an error. 



5.1.2 Data/User Error 
Example : 

Mispunched ASCII card, blank tape read. 
Action: 

No recovery can be performed; a completion code 
indicating the type of error will be returned to the 
caller . 



5.1.3 Read/Write/Transmission Error 
Examples : 

Tape parity error, disk checkword error, channel parity 
error . 
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5. ERROR RECOVERY AND LOGGING 



5.1 Error Recovery 

lOQ will perform all error recovery for normal I/O requests. 
The action taken depends on the device type and the status 
returned from the I/O operation. 

Basically there are five distinct types of status which may 
occur during an I/O operation. These are listed in the 
following paragraphs with examples and action taken. 



5.1.1 Normal Completion 
Example : 

Channel Ready 
Action : 

This the normal completion of an I/O request; a normal 
completion code is returned to the caller (i.e., to the 
DCB and/or end-action routine). This category includes 
status codes that indicate that the MFC (microprogrammed 
controller) firmware corrected an error. 



5.1.2 Data/User Error 
Example : 

Mispunched ASCII card, blank type read. 
Action : 

No recovery can be performed; a completion code 
indicating the type of error will be returned to the 
caller . 



5.1.3 Read/Write/Transmission Error 
Examples : 

Tape parity error, disk checkword error, channel parity 
error . 
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Action : 



There are a variety of recovery techniques that may be 
used depending on the device type and the nature of the 
error. In some cases, the MPC for the device will retry 
the operation several times. If one of these retries is 
successful, a normal completion status will be returned 
to the CPU (see Section 5.1.1). If not, lOQ will 
perform recovery sequences which include additional 
retries. If one of these retries is successful, a 
normal completion code will be returned to the caller. 
If not, an unrecoverable error completion code will be 
returned to the caller. 



Card reader hopper empty, line printer paper jam. 



This type of status is divided into two sub-categories: 

1 ) Those conditions that the operator can correct such 
as a card reader hopper empty condition. For these 
conditions, lOQ will notify the operator of the 
problem, wait for the special interrupt signifying 
that the device is ready, then retry the I/O 
operation . 

2) Those conditions which may also require action by 
the caller, such as a line printer paper jam. For 
these conditions, lOQ will notify the operator and 
return an error completion code to the caller. The 
caller, usually a symbiont, can then conduct his 
own dialogue with the operator, reposition the 
print file, if necessary, and reissue the I/O 
request. (lOQ will wait for the special interrupt 
signifying that the device is ready before issuing 
the I/O request to the device.) 



5.1.4 Device Requires Operator Intervention 



Examples : 



Action : 



5.1.5 Software Errors 



Example : 



Invalid instruction sequence. 



SF section: 14.4 

doc # : 0160B-0 

date : 770620 

page : 19 



Action : 

This type of status response to an I/O operation can 
only be caused by software errors in ICQ; it will cause 
a system crash. 



5.2 Error Logging 

In order to provide both immediate device error information 
as well as a record for later analysis, ICQ will keep a 
device error log as part of the system error log. It will 
contain two types of entries: 

1) Every error status received will be logged, including 
those that indicate that the MPC successfully corrected 
an error. This type of entry will contain a time stamp, 
the external device ID, the lOM number, channel number, 
and MPC ID, the IDCW, the status word or doubleword, any 
other status information available, such as the extended 
status bytes generated by the unit record equipment, and 
the volume ID, if applicable. 

2) Whenever a tape or disk volume ID is dismounted and 
periodically, if a volume remains mounted for an 
extended period of time, the device operation statistics 
will be read from the MPC and logged. This type of 
entry will include a time stamp, the external device ID, 
the MPC ID, the volume ID, and the device operation 
statistics . 
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TEST AND DIAGNOSTICS (T&D) 

The T&D interface to ICQ will provide direct access to 
peripheral devices, MFCs, and lOMs (Input-Output 
Multiplexors) so that preventive and emergency maintenance 
can be performed on devices that have been partitioned out of 
the active system. This interface will be implemented so 
that a hardware diagnostic program can be a user job running 
in slave mode. The interface will allow the caller to 
specify: 

0 The device to be tested (external device ID), 

o The path to that device (lOM number, channel number), 
and 

0 The PCW (Peripheral Control Word) and channel program to 
be issued to the device. 

On completion of the request, the T&D interface will return 
the status doubleword and the contents of the channel *s 
mailbox, whether in scratchpad or in memory, to the caller. 
No error recovery will be performed. If a special or fault 
interrupt occurs for the specified channel during the 
request, the status word from that interrupt will be returned 
to the caller, terminating the request. 

The T&D interface will check all requests to ensure that 
system security is not compromised : 

0 Perpheral Device Access 

The requested device must be partitioned out. (T&D 
cannot be performed on a device which is available to 
CP-6.) The interface will set the device number field 
in each IDCW so that only device commands will be 
accepted by the hardware. 

0 MPC Access 

The requested MPC (i.e., all channels connected to that 
MPC) must be partitioned out. Device commands will be 
accepted only if they refer to devices which are 
partitioned out. 

0 lOM Access 

The T&D interface will allow access to the snapshot, 
wraparound, and scratchpad access channels. The PCWs 
will be checked to ensure that only partitioned-out 
channels are accessed. 



